home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / win / cinstp17.zip / AUTOCALC.TXT < prev    next >
Text File  |  1995-02-09  |  10KB  |  227 lines
  1.                                 AUTOCALC.EXE
  2.                                 ------------
  3.  
  4. This program is a little utility to remove the tedium from working out the
  5. space requirements of your application when preparing your WINSTALL.INF
  6. file. It automates the process of calculating the space requirements and
  7. writes the results to a file which you can then import into your INF file.
  8.  
  9.  
  10. Specifically, the program does the following;
  11.  
  12. [a] read the $DISK      lines in your WINSTALL.INF file
  13. [b] read the $WINDIR    lines in your WINSTALL.INF file
  14. [c] read the $SYSDIR    lines in your WINSTALL.INF file
  15. [d] read the $TEMPDIR   lines in your WINSTALL.INF file
  16. [e] read the $OPTIONAL  lines in your WINSTALL.INF file
  17. [f] check for all the files on those lines
  18. [g] obtain the sizes of the files (if a file is compressed, it gets
  19.     the size of the expanded image of the file)
  20. [h] total the sizes of all the files in the installation set
  21. [i] total the sizes of the files that make up each user option
  22. [j] total the sizes of the files that go into the Windows directory
  23. [k] total the sizes of the files that go into the Windows SYSTEM directory
  24. [l] total the sizes of the files that go into the TEMP directory
  25.     (for $SWAP-SPACE)
  26. [m] add 0.5% to each of the figures, as a safety margin (because of disk
  27.     cluster sizes)
  28. [n] display the results on the screen
  29. [o] write the result into a file (OPTIONS.LOG), and/or the Windows clipboard
  30.     in the format required for the INF file (you can then paste from the
  31.     clipboard, or import the contents of the file into your INF file) to
  32.     replace the
  33.         $SPACE
  34.         $WINDIR-SPACE
  35.         $SYSDIR-SPACE
  36.         $SWAP-SPACE
  37.         $USER-OPTION
  38.     lines
  39.  
  40. It would be a lot easier if these lines were grouped togther, near the
  41. beginning of your INF file.
  42.  
  43. Please try to ensure that the directory in which the files are only contains
  44. files that will go on your installation disks - otherwise, the calculations
  45. might be wrong. Also, try to be a little specific in your use of wildcards
  46. on $DISK lines (especially if your installation set consists of more than 1
  47. disk) - e.g., do NOT do something like;
  48.  
  49.    $DISK1=*.*
  50.    $DISK2=*.*
  51.    $DISK3=*.??_
  52.    $DISK4=*.??_
  53.  
  54. This will only confuse the program, and the same files will be processed
  55. over and over again. One common cause of inaccurate space calculations by
  56. AUTOCALC is the indiscriminate use of wildcard characters. Please NOTE this
  57. point.
  58.  
  59.  
  60. The program is a simple Windows program. If run without any argument, it
  61. looks for WINSTALL.INF, and the installation files, in the current directory
  62. and writes its output to OPTIONS.LOG in the current directory. Note that
  63. only one directory is checked for the installation files. Thus it is
  64. advisable to have all your installation files in a single directory on a
  65. hard drive, and run this program there before copying the files onto
  66. floppies.
  67.  
  68.  
  69. It can also take 2 arguments. If arguments are used, they must be in the
  70. following format;
  71.  
  72. arg 1 = the directory in which your installation files are located
  73.         (your WINSTALL.INF file must also be in that directory)
  74. arg 2 = the name of the output file
  75.  
  76.  
  77. If you are going to use the *second* argument, you MUST use both of them
  78. (because the directory must always be the first argument).
  79.  
  80. e.g., if you have prepared all the file for your installation disks
  81.       and they are currently in a directory called C:\FINAL, waiting
  82.       for copying to the installation disks, you can run the following
  83.       command, to finalise you WINSTALL.INF file's details;
  84.  
  85.         AUTOCALC c:\final c:\temp\myopt.txt
  86.  
  87.      or
  88.  
  89.         AUTOCALC c:\final
  90.  
  91.  
  92. NOTES:
  93. ------
  94. 1. AutoCalc sometimes gives you a negative value for $SPACE (or any of the
  95.    others). In such cases, simply replace the negative value with a ZER0.
  96. 2. Sometimes the space calculations produced by AutoCalc are not accurate.
  97.  
  98.    There are many causes for wrong calculations by AUTOCALC. The primary
  99.    cause is indiscriminate use of wildcards in your INF file. Other causes,
  100.    which might be related to the one already mentioned are:
  101.  
  102.             [a] Mixing wildcards and full file names on $DISK, $SYSDIR,
  103.                 $WINDIR, $TEMPDIR, and $OPTIONAL lines - this might
  104.                 result in some files being processed more than once.
  105.  
  106.             [b] Having files in the directories being processed by
  107.                 AUTOCALC which files are not going to be on your
  108.                 distribution disks.
  109.  
  110.     The bottom line is this - if you are going to use wildcards on your
  111.     $DISK and/or $OPTIONAL lines, you need to think very carefully about
  112.     what you are doing. It is up to you to arrange your lines so that no
  113.     file is liable to be processed twice - this is because AUTOCALC
  114.     processes your INF file _exactly_ as it finds it.
  115.  
  116.     In my view, it advisable to AVOID mixing wildcards and full file names
  117.     on $OPTIONAL lines. Either use ONLY wildcards, or ONLY full file names.
  118.     But if you are NOT relying on AutoCalc for your space calculations, then
  119.     you can freely mix wildcards and full file names.
  120.  
  121.  
  122. -----------------------------------------------------------------------
  123.  
  124.                               "ADVANCED" FEATURES
  125.                               --------------------
  126. These features are meant for those who are not worried about getting
  127. their hands dirty. If seemingly complicated INI files and stuff is not 
  128. your cup of tea, then please STOP reading now!
  129.  
  130. AUTOCALC has been revamped in many ways. You can still run it EXACTLY as
  131. described above - but there is added functionality. It will optionally
  132. produce a full template for an INF file (in a file called FINAL.INF), in
  133. which you can later fill in the details.
  134.  
  135. For these purposes, AUTOCALC can use an INI file (default = AUTOCALC.INI) to
  136. get details about your program's files. This file is a sort of "MAKE" file,
  137. which AUTOCALC will parse before processing and writing out your full
  138. template.
  139.  
  140. Any $USER-OPTION option and $OPTINAL lines should be in a file called
  141. OPTIONS.INF. This file will be read to process your USER OPTIONS and the
  142. processed information will eventually by written by AUTOCALC into your
  143. template INF file (by default, this is called FINAL.INF)
  144.  
  145. To activate this new functionality, you need to supply /FULL as the *first*
  146. parameter to AUTOCALC.EXE.
  147.  
  148. The *second* parameter (if /FULL is the first parameter) can be either;
  149.  
  150.           [a] a directory path (this is where all your program's files
  151.               are) - this directory willl be scanned, and ALL the files in
  152.               it will be used to create $DISK lines.
  153.  
  154.            or
  155.  
  156.           [b] /f=<INIfilename>
  157.  
  158.  
  159. NOTE that if you do not have an AUTOCALC.INI file in the directory from
  160. which AUTOCALC is run, then you must supply a second parameter (after
  161. /FULL). If you have the AUTOCALC.INI file, then it will be read for details
  162. about your program's files. The format of the INI file is as follows;
  163.  
  164.        $SOURCEDIR = the directory where ALL your program's files are
  165.                     (this directory must contain only the files which
  166.                     are going to be on your disktribution disks, and
  167.                     must include files which will go into the $SYSDIR
  168.                     $WINDIR and $TEMPDIR directories as well)
  169.  
  170.                     If you have more than 1 disk, then you should create
  171.                     a subdirectory under this directory for each of the
  172.                     other disks, and put each disk's files into its own
  173.                     subdirectory. AUTOCALC will automatically scan
  174.                     $SOURCEDIR for subdirectories called;
  175.  
  176.                       DISK2, DISK3, DISK4, etc., each of them representing
  177.                       files for other disks in your installation set.
  178.  
  179.  
  180.        $OPTIONS   = filename which contains your user option declarations
  181.  
  182.        $SYSDIR    = directory which holds the files which go into $SYSDIR
  183.                     (you can put dummy files with zero bytes here).
  184.                     If this line is empty, AUTOCALC will look for the
  185.                     files in $SOURCEDIR\SYSDIR.
  186.  
  187.        $WINDIR    = directory which holds the files which go into $WINDIR
  188.                     (you can put dummy files with zero bytes here).
  189.                     If this line is empty, AUTOCALC will look for the
  190.                     files in $SOURCEDIR\WINDIR.
  191.  
  192.        $TEMPDIR   = directory which holds the files which go into $TEMPDIR
  193.                     (you can put dummy files with zero bytes here).
  194.                     If this line is empty, AUTOCALC will look for the
  195.                     files in $SOURCEDIR\TEMPDIR.
  196.  
  197.        $INF-FILE  = the name of the template INF file to be produced
  198.                     (default = $SOURCEDIR\FINAL.INF)
  199.  
  200.  
  201.        e.g.,
  202.  
  203.        $SOURCEDIR=c:\install\new\release
  204.        $OPTIONS=c:\install\ver16opt.inf
  205.        $SYSDIR=
  206.        $WINDIR=
  207.        $TEMPDIR=
  208.        $INF-FILE=c:\install\testing.inf
  209.  
  210.  
  211.   AUTOCALC can also take a last parameter /COPY. If used, this *must*
  212.   be the 3rd parameter passed to AUTOCALC.EXE. When used, AUTOCALC will
  213.   try to create your installation disks for you by copying the files
  214.   from your $SOURCEDIR and $SOURCEDIR\DISK# directories to a designated
  215.   destination. You will be asked to supply the destination directory/drive
  216.   at the appropriate moment. This feature is probably very buggy.
  217.  
  218.   -------------------
  219.  
  220.   Examples of running AUTOCALC with /FULL parameter;
  221.  
  222.   AUTOCALC /FULL c:\install2\release
  223.   AUTOCALC /FULL /f=c:\install2\prog1.mak
  224.   AUTOCALC /FULL /f=c:\install2\prog1.mak /COPY
  225.  
  226.   ---------------------------------
  227.